跳到主要内容

开始接入（Getting Started）

本页带你完成：安装插件 → 导入 .riv → 创建 Widget → 绑定 ViewModel。

支持 Unreal Engine 5.7.3+。

1）安装插件​

Fab（推荐）​

  1. 打开 Epic Launcher 或 Unreal Editor
  2. 打开 Fab
  3. 搜索 Rive，或直接访问：
  4. 安装到引擎或项目
  5. 按提示重启 Unreal

GitHub​

git clone https://github.com/rive-app/rive-unreal.git

把 Rive 插件目录放到项目 Plugins/，然后重新生成项目并编译。

2）启用插件​

  1. 打开 Edit -> Plugins
  2. 在 Runtime 下找到 Rive
  3. 启用并重启编辑器（如提示）

3）导入 Rive 文件​

将 .riv 拖进 Content Browser。Unreal 会创建 Rive File 资产。

注意：Rive File 是资产对象，本身不会直接渲染。

Unreal 目前不支持 Referenced 资源，请在 .riv 中使用 Embedded 资源。

4）创建 Widget​

右键 Rive File 资产，选择 Create Rive Widget。

你可以双击查看生成的 Widget 配置。

5）在 Blueprint 使用​

和普通 Widget 一样把它加进 Blueprint / UMG。

6）绑定 ViewModel​

若文件未启用自动绑定（autobinding），需要手动通过 Make View Model 创建并绑定实例。

完成后就可以在应用中驱动 Rive 内容。下一步建议看：